// Copyright 2012 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef MEDIA_BASE_VIDEO_CODECS_H_
#define MEDIA_BASE_VIDEO_CODECS_H_

#include <stdint.h>
#include <string>
#include "media/base/media_export.h"
#include "media/media_features.h"

namespace media {

enum VideoCodec {
    // These values are histogrammed over time; do not change their ordinal
    // values.  When deleting a codec replace it with a dummy value; when adding a
    // codec, do so at the bottom (and update kVideoCodecMax).
    kUnknownVideoCodec = 0,
    kCodecH264,
    kCodecVC1,
    kCodecMPEG2,
    kCodecMPEG4,
    kCodecTheora,
    kCodecVP8,
    kCodecVP9,
    kCodecHEVC,
    // DO NOT ADD RANDOM VIDEO CODECS!
    //
    // The only acceptable time to add a new codec is if there is production code
    // that uses said codec in the same CL.

    kVideoCodecMax = kCodecHEVC // Must equal the last "real" codec above.
};

// Video codec profiles. Keep in sync with mojo::VideoCodecProfile (see
// media/mojo/interfaces/media_types.mojom) and gpu::VideoCodecProfile (see
// gpu/config/gpu_info.h), as well as PP_VideoDecoder_Profile (translation is
// performed in content/renderer/pepper/ppb_video_decoder_impl.cc).
// NOTE: These values are histogrammed over time in UMA so the values must
// never ever change (add new values to tools/metrics/histograms/histograms.xml)
enum VideoCodecProfile {
    // Keep the values in this enum unique, as they imply format (h.264 vs. VP8,
    // for example), and keep the values for a particular format grouped
    // together for clarity.
    VIDEO_CODEC_PROFILE_UNKNOWN = -1,
    VIDEO_CODEC_PROFILE_MIN = VIDEO_CODEC_PROFILE_UNKNOWN,
    H264PROFILE_MIN = 0,
    H264PROFILE_BASELINE = H264PROFILE_MIN,
    H264PROFILE_MAIN = 1,
    H264PROFILE_EXTENDED = 2,
    H264PROFILE_HIGH = 3,
    H264PROFILE_HIGH10PROFILE = 4,
    H264PROFILE_HIGH422PROFILE = 5,
    H264PROFILE_HIGH444PREDICTIVEPROFILE = 6,
    H264PROFILE_SCALABLEBASELINE = 7,
    H264PROFILE_SCALABLEHIGH = 8,
    H264PROFILE_STEREOHIGH = 9,
    H264PROFILE_MULTIVIEWHIGH = 10,
    H264PROFILE_MAX = H264PROFILE_MULTIVIEWHIGH,
    VP8PROFILE_MIN = 11,
    VP8PROFILE_ANY = VP8PROFILE_MIN,
    VP8PROFILE_MAX = VP8PROFILE_ANY,
    VP9PROFILE_MIN = 12,
    VP9PROFILE_PROFILE0 = VP9PROFILE_MIN,
    VP9PROFILE_PROFILE1 = 13,
    VP9PROFILE_PROFILE2 = 14,
    VP9PROFILE_PROFILE3 = 15,
    VP9PROFILE_MAX = VP9PROFILE_PROFILE3,
    HEVCPROFILE_MIN = 16,
    HEVCPROFILE_MAIN = HEVCPROFILE_MIN,
    HEVCPROFILE_MAIN10 = 17,
    HEVCPROFILE_MAIN_STILL_PICTURE = 18,
    HEVCPROFILE_MAX = HEVCPROFILE_MAIN_STILL_PICTURE,
    VIDEO_CODEC_PROFILE_MAX = HEVCPROFILE_MAX,
};

std::string MEDIA_EXPORT GetCodecName(VideoCodec codec);
std::string MEDIA_EXPORT GetProfileName(VideoCodecProfile profile);

// ParseNewStyleVp9CodecID handles parsing of new style vp9 codec IDs per
// proposed VP Codec ISO Media File Format Binding specification:
// https://storage.googleapis.com/downloads.webmproject.org/docs/vp9/vp-codec-iso-media-file-format-binding-20160516-draft.pdf
// ParseLegacyVp9CodecID handles parsing of legacy VP9 codec strings defined
// for WebM.
// TODO(kqyang): Consolidate the two functions once we address crbug.com/667834
MEDIA_EXPORT bool ParseNewStyleVp9CodecID(const std::string& codec_id,
    VideoCodecProfile* profile,
    uint8_t* level_idc);
MEDIA_EXPORT bool ParseLegacyVp9CodecID(const std::string& codec_id,
    VideoCodecProfile* profile,
    uint8_t* level_idc);

// Handle parsing AVC/H.264 codec ids as outlined in RFC 6381 and ISO-14496-10.
MEDIA_EXPORT bool ParseAVCCodecId(const std::string& codec_id,
    VideoCodecProfile* profile,
    uint8_t* level_idc);

#if BUILDFLAG(ENABLE_HEVC_DEMUXING)
MEDIA_EXPORT bool ParseHEVCCodecId(const std::string& codec_id,
    VideoCodecProfile* profile,
    uint8_t* level_idc);
#endif

MEDIA_EXPORT VideoCodec StringToVideoCodec(const std::string& codec_id);

} // namespace media

#endif // MEDIA_BASE_VIDEO_CODECS_H_
